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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 



This Technical Specification (TS) has been produced by ETSI Technical Committee GRID (GRID). 
The present document is related to document 102-828 (GCM Interoperability Application Description). 



Introduction 



The purpose of the present document is to offer a standard, uniform way of describing grid resources, so as to make 
these resources available to grid-based applications. 

When building a grid, one is confronted to several problems, among which: 

• choosing a grid framework, as many are available. 

• when running a grid-enabled application, one must rewrite configuration directives when switching to a 
different grid framework. 

• a grid can be built on widely different hardware infrastructures, from an heterogenous set of desktop machines 
to a dedicated cluster, or even any combination of those. 

• grid infrastructures can also be very dynamic, it should be easy to add or remove machines, and such changes 
should be transparent to users. 

To simplify this, the GCM Interoperability Deployment standard offers a uniform way to describe grid resources, how 
they are connected to one another, how they can be activated, and how they can be accessed. 

A grid infrastructure is modelized with several entities: Host, Bridge, and Group (see definitions clause). By combining 
these entities, one can describe the physical infrastructure of the grid, i.e. how the machines it includes are configured 
and networked together. 

The GCM has been first defined in the NoE CoreGRID (42 institutions). A reference Open Source implementation has 
been tested in the 4 previous GRID Plugtests organized from 2004 to 2007 by ETSI, and will also be part of the 
forthcoming 5* one in 2008. The GridCOMP EU project (FP6, started June 2006 to November 2008) is working to 
further assess and experiment with the specification. 
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Scope 



The present document describes an XML schema for describing resources to be used in distributed and parallel 
infrastructures like enterprise and scientific grids and job schedulers. 

The standard will help enterprises and laboratories to manage large-scale computer and telecom infrastructures with the 
necessary virtualization. 

Its primary audience are grid system administrators who will need to write deployment descriptors for their grid. 



2 References 

References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• Non-specific reference may be made only to a complete document or a part thereof and only in the following 

cases: 

if it is accepted that it will be possible to use all future changes of the referenced document for the 
purposes of the referring document; 

for informative references. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

For online referenced documents, information sufficient to identify and locate the source shall be provided. Preferably, 
the primary source of the referenced document should be cited, in order to ensure traceability. Furthermore, the 
reference should, as far as possible, remain valid for the expected life of the document. The reference shall include the 
method of access to the referenced document and the full network address, with the same punctuation and use of upper 
case and lower case letters. 

NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee 
their long term validity. 

2.1 Normative references 

The following referenced documents are indispensable for the application of the present document. For dated 
references, only the edition cited applies. For non-specific references, the latest edition of the referenced document 
(including any amendments) applies. 

[1] ETSI TS 102 828: "GRID; Grid Component Model (GCM); GCM Application Description". 

2.2 Informative references 

The following referenced documents are not essential to the use of the present document but they assist the user with 
regard to a particular subject area. For non-specific references, the latest version of the referenced document (including 
any amendments) applies. 

[i.l] ARC / Nordugrid: "middleware for grid computing". 

NOTE: Available at http://www.nordugrid.org/ . 

[i.2] CGSP / China Grid: "middleware for ChinaGrid" . 

NOTE: Available at http://www.cngrid.org 
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[i.3] EGEE gLite: "middle-ware for grid computing". 

NOTE: Available at http://glite.web.cern.ch/glite/ . 

[i.4] Fura / Inner Grid: "middleware for grid computing". 

NOTE: Available at http://fura.sourceforge.net/ . 

[i.5] Globus: "open source software toolkit to build Grid systems and applications". 

NOTE: Available at http://www.globus.org/ . 

[i.6] GridBus: "middleware for grid computing". 

NOTE: Available at http://www.gridbus.org/middleware/ . 

[i.7] IBM Load Leveler: "job scheduler". 

NOTE: Available at http://www.ibm.com/svstems/clusters/software/loadleveler/ , 

http://publib.boulder.ibm.com/infocenter/clresctr/vxrx/topic/com.ibm.cluster.loadl.doc/loadl331/am2ug30 
323.html#iobkev . 

[i.8] LSF: "job scheduler". 

NOTE: Available at http://www.platform.com/products/ LSF / . 

[i.9] OAR: "job scheduler". 

NOTE: Available at http://oar.imag.fr/docs/manual.html . 

[i . 1 0] PB S / Torque : "j ob scheduler" . 

NOTE: Available at http://www.clusterresources.com/pages/products/torque-resource-manager.php . 

[i. 11 ] PBS / PRUN: "run server from an old version of PBS" . 

NOTE: Available at http://www.cs.vu.nl/das/prun/prun. 1 .html . 

[i.l2] Sun GridEngine: "grid computing framework". 

NOTE: Available at http://gridengine.sunsource.net/ . 

[i.l3] CCS: "Microsoft Compute Cluster Server". 

NOTE: Available at http://www.microsoft.com/windowsserver2003/ccs/default.aspx . 

3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

bridge: GCM Deployment concept that represents a machine through which multiple machines are accessed 

NOTE: A typical example is a cluster frontend (see frontend). 

certificate: electronic document which incorporates a digital signature to bind together a public key with an identity - 
information such as the name of a person or an organization, their address, and so forth 

certificate autliority: entity which issues digital certificates for use by other parties 

cluster: set of loosely-coupled machines working together so that they are seen as a single computer 
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Core (CPU Core): processing unit within a processor chip, effectively seen as a CPU from the Operating System 

NOTE: For instance, a dual -core CPU will be seen as two CPUs by the OS. 

deployment descriptor: XML file following the schema specified in the present document, which describes what grid 
resources are to be deployed and how 

frontend: in a physical network, a single machine acting as a gateway for a set of machines 

NOTE: This is often the case for machine clusters, where individual machines are not accessible directly. 

Grid Component Model (GCM): component architecture and framework for the portability, and reusability of Grid 
applications, the integration with SOA infrastructures, and providing interoperability of GRID systems 

group: GCM Deployment concept that represents a set of machines (i.e. hosts, see definition) and the grid protocol 
through which they can be accessed 

NOTE: These machines may all be sharing the same configuration (OS type, installation path of executable etc.), 
but it may also only have the same grid protocol while having very different configurations. A group is 
generally used to represent a cluster. 

host: GCM Deployment concept which represents a single physical machine on a network 

NOTE: A GCM Deployment model can be seen as a tree, and hosts are the leaves. 
Host Capacity (HC): number of programs or VM per Host 

NOTE: An indicator of the number of programs to be executed in parallel on a host. 

infrastructure: organized set of processing resources which form a grid 

job scheduler: program which purpose is to manage a queue of program execution requests (jobs) in order to run them 
in turn, or at a specified time 

node: GCM Deployment concept that represents a location to execute a computation 

NOTE: At execution, a node is a place where a program or an activity can be executed. This can be a single 

physical machine (a host), or, in the case of a multi-processor / multi-core machine, a single processor or 
a single core within a machine. 

resource: processing unit which is a building part of the grid 

NOTE: A resource can either be a host (a single physical machine), a bridge (a frontend machine providing 
access to several others), or a group (a set of identical machines). 

Service Oriented Architecture (SOA): computer system's architectural style for creating and using business processes, 
packaged as services, throughout their lifecycle 

Schema (XML Schema): set of structure constraints for an XML document 

NOTE: They provide a means for defining the structure, content and semantics of XML documents. Schemas are 
a W3C recommendation. See http://www. w3 .org/XML/Schema . 

Virtual Machine (VM): software implementation of a computer that executes programs like a real machine 

VM Capacity (VMC): number of activities or node- per VM - an indicator of the number of activities (threads) to be 
executed in parallel within a program 

NOTE: In a standard approach, the *Host Capacity x VM Capacity* should be set to the number of CPU cores of 
the machine. However, these indicators are by no means absolute. They can be tuned to take into account 
the specifications of the platform (memory, network, etc.), or of the tasks to be executed in order to obtain 
the desired load. 
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Virtual Node (VN): set of nodes -A Virtual Node is an abstraction for deploying parallel and distributed applications. 
A VN, after a GCM deployment, refers to a set of Nodes, which is seen as a single entity 

NOTE: Without JVMs, at execution, a VN maps to a set of Hosts, each Host containing a set of Nodes. With 
J VMs, at execution, a VN maps to a set of Hosts, each Host containing a set of JVMs, each JVM 
containing a set of Nodes. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CA Certification Authority 

CPU Central Processing Unit 

GCM Grid Component Model 

HC Host Capacity 

JVM Java Virtual Machine 

OS Operating System 

RSH Remote Shell 

SOA Service Oriented Architecture 

SSH Secure Shell 

VM Virtual Machine 

VMC Virtual Machine Capacity 

VN Virtual Node 

XML extensible Markup Language 



Overall resource specification 



The purpose of the following clauses is to explain the "model toolkit" that the GCM Deployment offers to describe a 
grid. As explained in the introduction, a grid can be almost any kind of machines networked together. We detail here 
how to represent any given setup through the GCM Deployment standard. 



4.1 Principles 



A deployment descriptor is written in XML. The XML document must conform to the GCM Deployment schema 
(specified in the present document). 

A deployment descriptor is meant to be referenced by an application descriptor, which is the description of the 
application that will be run, and its resource requirements (GCM Application Descriptor, described in the companion 
document TS 102 828 [1]). 

The benefit of the deployment/application split is that the infrastructure part (which is described by the present 
document) is reuseable for any other deployment on the same grid. It can also be used by schedulers and 
meta-schedulers. 

A grid infrastructure is modelized through three kinds of resources: hosts (single machines), groups (a set of machines) 
and bridges (a single machine acting as a gateway for groups or hosts). 

The model is defined in two parts: 

1) Infrastructure: this is a flat list of each individual element of the grid: hosts, groups and bridges listed 
in no particular order. 

2) Resources: this is a tree describing the hierarchical relationships between these infrastructure elements. 
These relationships are defined by: 

■ a host being within which group; 

■ a group being behind a bridge; 

■ a host being directly available. 
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Considering a very simple grid, that is two desktop PCs networked together. Such a setup would be represented as 
follows (configuration parameters are omitted for the sake of clarity): 

<resources> 
<hosts> 

<host ref id="hostl" /> 
<host ref id="host2" /> 
</hosts> 
</resources> 

<inf rastructure> 
<hosts> 

<host id="hostl" /> 
<host id="host2" /> 
</hosts> 
</inf rastructure> 

There is no hierarchical relation between the two hosts, so both resources and infrastructure parts are identical (aside of 
the extra configuration parameters which are omitted here). 

A slightly more complex example would be a cluster of 12 mono-processor machines running LSF. The representation 
in GCM Deployment would be as follows: 

<resources> 

<group refid="LSF_GROUP"> 

<host refid="LSF_GROUP_MEMBER" /> 
</group> 
</resources> 

<infrastructure> 
<hosts> 

<host id="LSF_GROUP_MEMBER" /> 
</hosts> 

<groups> 

<lsfGroup id="LSF_GROUP" > 

<resources processorNumber="12" /> 
</lsfGroup> 
</groups> 
</infrastructure> 

Within the <infrastructure>, the <hosts> part describes the configuration common to the machines in the group. The 
<groups> part describes the LSF group itself Finally, the <resources> part describes how they fit together, in this case 
the host model being within the LSF group. 

The following clauses give the complete reference on how a grid can be described through the GCM deployment. 



4.2 Overall structure of a descriptor 

A deployment descriptor has the following XML structure: 



< environment > 

<descriptorVariable .../> 

</ environment > 

<resources> 

<bridge .../> 
< group > 

<host .../> 

<host .../> 

</ group > 
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</resources> 

<acquisition> 

< lookup .../> 
<p2p .../> 

</acquisition> 

<inf rastructure> 
<hosts> 

<host.../> 
</hosts> 

< group s> 

<groupType .../> 
</ group > 

<bridges> 

<bridgeType .../> 
</bridges> 

</inf rastructure> 

The elements must be specified in this order. The <environTnent> and <acquisition> elements can be 
omitted, while the <resources> and <inf rastructure> ones are mandatory. The next paragraphs go more in 
depth on the content and usage of each element. 

4.2.1 Environment element 

To allow for a bit of flexibility, it is possible to define variables in a descriptor. The variables can be used in any XML 
value element. They cannot be used in an XML element name. The <environTnent> element is where the variables 
are defined. It is a simple list of <descriptorVariable> elements. There is no limitation on the number of 
elements. The element has only two attributes, "name" and "value", each accepting string values. The element cannot 
have child elements. 

EXAMPLE: 

< environment > 

<descriptorVariable name="usertype" value="admin" /> 
<descriptorVariable name="username" value="j smith" /> 
</ environment > 

This allows the following usage later on in the decriptor: 

<sshGroup user="${username} " /> 



4.2.2 Resources element 

The <resource> element describes the hierarchical structure of the available grid resources. This can be seen as the 
topology of the grid: which hosts are part of a group, which group is behind a bridge, etc. All the grid resources which 
are listed in it are fully defined in the <inf rastructure> element. However it does not have to hold every element 
listed in <inf rastructure>, it is meant to contain only the subset of resources which are actually used by the 
deployment. This is to give further flexibility in the descriptor, in that the infrastructure part can be kept while the 
resource part is changed to suit the current deployment needs. See clause 4 for some examples of the <resource> tag. 

There are 3 possible elements within the <resource> element: 

1) <host> 

2) <group> 

3) <bridge> 
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These elements all take a single argument named 'refid'. The value of the argument is the id of the corresponding 
host/bridge/group element defined in the <infrastructure> element. The topology must be described according to the 
following rules: 

• A host can be at the top level, or in a group element. 

• A group can be at the top level, or in a bridge element. 

• A bridge can only be at the top level. 

For example, the following constructions are correct: 
Single host: 

<host refid="A_HOST" /> 

Group: 

<group refid="CLUSTER"> 

<host refid="CLUSTER_NODE" /> 
</ group > 

Group behind a bridge: 

<bridge ref id="CLUSTER_FRONT_END" /> 

<group ref id=" CLUSTER" > 

< host refid="CLUSTER_NODE" /> 

< /group > 
< /bridge > 

4.2.3 Acquisition element and desktop grid 

The <acquisition> element describes how resources which are already running can be acquired. It can be used or 
extended towards standards for managing resources from desktop grids. It contains a simple sequence of two types of 
elements: <lookup> and <p2p>, in this order. Each element can either have a single occurrence or be omitted. 

The <lookup> element has the following three attributes: 

1) type: one of "RMI", "HTTP", "IBIS"; 

2) hostlist: a HostList as defined in clause 5.1.1; 

3) port: a positive integer. 

It cannot have any child elements. 

The <p2p> element has a single attribute named "nodes Asked", which holds a positive integer value, or the value 
'MAlK', indicating the number of requested nodes. The value 'M/VX' means that the maximum number of available 
nodes will be allocated to the task. If more nodes are made available during the course of the task's execution, they will 
be added as well. 

The <p2p> element can have two children. The first one is <localClient>, which defines the parameters for the 
local P2P client. These parameters are represented by two attributes: 

• protocol (enumeration), which can be one of 'RMI', 'HTTP', or 'IBIS'; 

• port (positive integer), which is the client's IP port number. 

The second child is <peerSet>, which is a simple sequence of <peer> elements. Each peer element is a string 
defining the url toward an access point to the p2p network. 
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Here is an example of an <acquisition> tag featuring all the tags described: 

<;acqu1 s1 11 on^ 

<l0Qkup type="Kni" port="6666" hostH st="host [Q-9] . gr1 d , f r" ></lookup> 
<p2p nodesAsked=" 5Q"> 

<localCl1ent protocol="Rnr" port="241Q" /> 
<peerSet > 

<peer>riii1;//schubby,inr1a,fr</peer> 
<peer?'http://gaud1,1nr1a,fr</peer> 
</peerSet > 
</p2p> 
</acqui s1 11 on> 

4.2.4 Infrastructure element 

The <inf rastructure> tag holds the list of grid resources on which the deployment can take place, in no particular 
order. Its purpose is to describe how these resources are deployed (i.e. through which protocols). It can have a single 
child element of each of the following types: <hosts>, <bridges>, <groups>. <bridges> and <groups> may 
be empty or omitted, but there should be at least one child element in <hosts>. The child elements which can be 
stored in these types are described in clause 5.2. 



5 Infrastructure specification 

5.1 Common types 

The following data types are used by many different elements defining the various grid and job scheduler protocols. 

5.1.1 Host list 

The format of a host list is a whitespace-separated list of name patterns or hostnames. A name pattern describes a set of 
hostnames with a common root. The format is as follows: 

<root name><interval> 

with root name being an alphanumeric string (only letters and digits, no spaces or punctuation signs), and interval 
defining a set of numerical values in the form of an interval or list of values, possibly followed by an exclusion interval 
or list of values. The general form of an interval is: 

[<value set>]'^[<value set>] 
or simply: 

[<value set>] 

if no exclusion interval is needed. 

A value set is a coma-separated list of integers or integers pairs separated by a dash, meaning an interval of values. The 
values of an interval must be specified in increasing order, and the generated values will be in increasing order. Also, 
the first integer of an interval can have leading zeroes to indicate the number of digits (numbers will be padded with 
zeroes if needed). 

Some examples: 

• host[0-5]: hostO, hostl ... hostS; 

• host[0-5]'^ [i.3]: hostO, hostl, host2, host3, hostS; 
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• host[0-10]'^[4-6]: hostO, hostl, host2, host3, host?, hostS, host9, hostlO; 

• host[00-5]: hostOO, hostOl, host02. . . hostOS; 

• host[l, 004-7, 09]: hostl, host004, hostOOS, host006, host007, host09. 
Here is the BNF grammar of a host Hst: 

hostList : := <host> { <host> } 

host ::= <pref ix><interval> | <interval><suf f ix> | <pref ixxintervalxsuf f ix> | <hostname> 

prefix : := letter { letter | digit } 
suffix : := letter { letter | digit } 
hostname : := letter { letter | digit } 

interval ::= " ["<valueset>"] " | " ["<valueset>"] " "^" " ["<valueset>"] " 

valueset ::= integer_or_interval { "," integer_or_interval } 

integer_or_interval ::= integer | <interval> 

interval ::= integer "-" integer 

5.1.2 ID 

An ID is an string of alphanumeric characters (no spaces nor punctuation signs). Each ID must be unique in the 
descriptor. 



5.1 .3 Path element and path string 



A path element has two attributes: 'base' and 'relpath'. 'base' defines what the path is relative to. The following values 
are defined: 



• root: the 'relpath' will be interpreted as an absolute path; 

• home: the home directory of the user under which the job is run. 



A path string is simply a text element which value represents a path in the format of the platform the path will be used 



on. 



5.1.4 Argument list 

An argument list is a simple list of <arg> elements, each holding a string value. 

5.2 Elements of the infrastructure 

This clause presents the concepts within the <inf rastructure> tag, which describes the actual deployment of 
resources on the grid infrastructure. Deployment is the process through which a machine becomes part of the grid (this 
generally involves starting the appropriate program on the machine). There are three types of deployment: 

1) Host: deployment of a single machine which is reached directly, with no intermediate. 

2) Bridge: deployment of one or several machines through a single gateway machine (the bridge). 

3) Group: deployment of several identically configured machines. 

5.2.1 Host description 

The Hostlnfo data structure describes a single machine and the environment it provides, with the following information: 

• userName: (string) the name of the user under which this host can be accessed; 

• homeDirectory: (absolute path) the home directory of the user; 
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• os: (one of "unix" or "windows") the operating system the host is running; 

• hostCapacity: (positive integer) the number of processes ( VM or other executable) that this host can handle 
(default value is 1); 

• vmCapacity: (positive integer) the number of nodes a single VM on this host can handle (default value is 1); 

• id: (ID) an ID identifying the host. 

HostCapacity and vmCapacity are both optional, however one cannot be specified without the other. Either they are 
both specified or not at all. 

The purpose of the Hostlnfo structure is to abstract an application from its environment, and therefore to make its 
adaptation to other environments easier. 



(□ hostType JB- 
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Figure 1 



5.2.2 Bridge description 



A bridge is meant to represent a frontend to a computing resource. Many grid architectures have such a feature: each 
physical machine is not accessible directly, the user must instead go through a single machine called a front-end. In a 
deployment descriptor, a bridge is a gateway toward either: 

• a host; 

• a set of groups; 

• another bridge. 

A bridge is defined as a base structure meant to be derived. The base structure only defines an id (string). 

@ id Ih 



[□ abstractBridgeElementlype Jb- 



Figure 2 

In addition, the following bridge types are defined, as they are the most widely used: rsh (6.1), ssh (6.2) and oarsh (6.3). 



ETSI 



17 



ETSI TS 102 827 VI .1.1 (2008-08) 



5.2.3 Group description 

A Group is a data structure defining a set of machines with identical configuration (like a cluster). It is meant as a base 
structure which can be derived in an Object-Oriented manner to implement any kind of group. There currently are two 
kinds of groups: 

1) "direct" groups; 

2) job schedulers. 

It is therefore possible to define a standard-compliant deployment descriptor even on a grid which has its own job 
scheduler. 

All group protocols have the following child elements: 

• environment (environment): the environment for the command, 
and the following attributes: 

• id (ID): the id of the group this element represents; 

• commandPath (path string): path of the command which is used to submit a job to the group protocol. 

I n abstranTupleElementTvpe jBi — | ""JB — en\ironment B — , v , v i — ^ — 

'^ ' • ' I 1 ( □ en\ironmentVariablesTM3e JB — (""JEH — ^variable 
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i ^ name tl — nTJS — (^ restrict!: jsiflring^ 
1 9 value J3 — f^V^ — [\^ restricts: jsdiStriiigVl 



type: variableTwe frotii: ComtiianTwes.ssd 



type: enWDntnentVariablesType from: CotnmoiiT^ei.iid 



' [ommandPatti 



Figure 3 

Direct group protocols have a supplemental attribute: 

• username (string): the username under which the job will be run. 



[□ abslractCroupElementTvpe JB vHP/El f <|[> extends: abstractTupleElementTvpe J Eh \ @ username Iffi 



Tq abstractTupleElemenlTvpe \a 
base: abstranTupleElementTvpe 



Figure 4 

Scheduler groups have the following child element: 

• scriptPatli (path element): the path to the job script which will be run. 
and the following supplemental attribute: 

• booliedNodeAccess ('sh', 'ssh', 'oarsh'): access method of the started nodes (the value must be set according to 
the group protocol the element describes). 
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6 Instances of bridge protocols (one to one) 

A bridge starts from one machine to go to a single other machine. It can be used to contact a resource through an SSH 
gateway for example. 

6.1 rsh 

An RSH bridge element can have the following attributes: 

• id (string): the id of the bridge connector corresponding to this definition; 

• hostname (string): the network hostname of the physical machine which acts as the bridge; 

• username (string, optional): the user name under which the machine can be accessed; 

• conunandPath (string, optional): the path of rsh client to use. 

fn bridgeTypeRSH jB xtP/B f <][> extends: pa: abstractBridgeElementType 2El-i i @ hostname iffl 
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6.2 



ssh 



An SSH bridge element can have the following child element: 

• privateKey (path string): the file of the private ssh key needed to access the bridge. 
An SSH bridge element can have the following attributes: 

• id (string): the id of the bridge connector corresponding to this definition; 

• liostname (string): the network hostname of the physical machine which acts as the bridge; 

• username (string, optional): the user name under which the machine can be accessed; 

• commandPath (string): the path of the ssh client to use; 
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• commandOptions (string): options to pass to the ssh command. 
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Figure 7 



6.3 oarsh 

An OARSH bridge element has the same parameters as an SSH bridge element, plus a 'jobid' (positive integer) 
mandatory attribute, which holds the OAR ID of the job. 

(n l3nclgeTypeOARSH)a (jS^B (<][> eitencis: pailDricigeTvpeSSH )e1-| ; @ JoUld JH 
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Figure 8 



6.4 



gsissh 



A gsissh bridge element has the same parameters as an ssh bridge element, plus two optional attributes: a 'port' 
(positive integer) which holds the port used by the gsissh server and 'certificate' that indicate the path of a valid pl2 
certificate delivered by a Certification Authority (CA). By default, these values follow standard Globus configuration, 
the port being retrieved on the $GLOBUS_LOCATION/etc/ssh/ssh_config file and the certificate on 
$HOME/. globus/usercred.p 1 2 . 
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7 



Instances of group protocols (One to N) 



In the following clauses, elements and attribute names which are underlined mean that the item is mandatory. 



7.1 Direct groups 



The following groups are simply sets of machines with a common configuration. To make the distinction with job 
schedulers, they are named "direct groups", since the deployment process directly accesses the machines in the group. 
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7.1.1 GroupSSH 



The SSH Group has the following child elements: 

• hostList (host list): the list of hosts to connect to. 

• privateKey (path string): the file of the private ssh key needed to access the host. 

• coimnandOptions (string): the list of options which will be passed to the ssh command. 
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Figure 10 



7.1.2 GroupRSH 



The rsh Group has the following child elements: 

• hostList (host list): the list of hosts to connect to 
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Figure 11 



7.1.3 GroupOARSH 



An oarsh group element has the same parameters as an ssh group element, plus a 'jobid' (positive integer) mandatory 
attribute, which holds the OAR ID of the job. 



fn oarshProi:essT\iDe Jb \[?^I3 ('<)|> enends: paigroupTvpessH ^Eh — \ ® JoUid I 
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Figure 12 

The following examples are group scheduling protocols. A scheduling protocol defines a way to communicate with a 
grid framework to submit job requests. The groups below allow the description of a deployment through such a 
framework. 
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7.1.4 ARC (NorduGrid) 



Group definition for the NorduGrid's Advanced Resource Connector [i.l]. 
The NorduGrid group definition has the following child elements: 

• count (positive integer): amount of sub-jobs to be submitted for parallel tasks; 

• arguments (argument list): list of arguments passed to the job executable; 

• inputFiles (sequence of 'ARCFileTransfer' elements): list of files to be copied to the grid before the execution. 
This element also has a 'cache' attribute (boolean) which specifies whether the files should be placed in the 
cache or not; 

• outputFiles (sequence of 'ARCFileTransfer' elements): list of files to be retrieved by the user; 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string): path of the file where the standard error of the job will be stored; 

• stdin (path string): path of the file from which the standard input of the job will be read; 

• maxTime (time): maximum amount of time the job is allowed to run; 

• notify (string): email notification on job status change. The string is of the format accepted by the 'notify' 
parameter as defined in ARC's XRSL task description language. 

It also has the following attribute: 

• jobName (string): the name of the job. 

[□ arcProcessTvpe JEI x[5>El— 
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Figure 13 

The ARCFileTransfer type is a simple list of <transfer> elements. A <transfer> element has only two 
attributes: 

• filename (string): the local name of the file; 

• location (string): the remote location of the file. 
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7.1.5 CGSP China Grid 

Group definition for the ChinaGrid middleware [i.2]. 

The CGSP group definition has the following child elements: 

• count (positive integer): number of executions of the executable; 

• directory (path string): the working directory of the job script; 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string): path of the file where the standard error of the job will be stored. 
It also has the following attributes: 

• hostname (string): the name of the CGSP node to which the job will be submitted; 

• queue (string): name of the queue to submit the job to. 



[ □ cgspProcessTvpe JB vIlJ/S ( <lt* e^ttends: ab5tractGroupSchedulerElemenlTvpe\£ 



directory 




hostname rB 



> 



f □ abstract Cm upSchGdu I erElementTvpe \±] 

base: a. ;dulerElementTvpe from: DeplQvmentDesiiriptQrSchema.^isd 



Figure 14 



7.1.6 EGEEgLITE 



Group definition for the EGEE gLite grid framework [i.3]. 
The gLite group definition has the following child elements: 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string): path of the file where the standard error of the job will be stored; 

• stdin (path string): path of the file from which the standard input of the job will be read; 

• arguments (argument list): list of arguments passed to the job executable. 
It also has the following attributes: 

• virtualOrganisation (string, required): name of the virtual organization the job submitter is working for; 

• nodes (postive integer): number of nodes requested. 
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Figure 15 

7.1.7 Fura/lnnerGrid 

Group definition for the Fura grid programming environment [i.4]. 
The Fura group definition has the following child elements: 

• description (string): a simple textual description of the job; 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string): path of the file where the standard error of the job will be stored; 

• stdin (path string): path of the file from which the standard input of the job wiU be read; 

• maxTime (time): maximum amount of time the job is allowed to run. 
It has one attribute: 

• jobName (string): the name of the job. 
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Figure 16 

7.1.8 GLOBUS 

Group definition for the Globus toolkit [i.5]. 

The GLOBUS group definition has the following child elements: 

• count (positive integer): number of executions of the executable; 

• maxTime (time): maximum amount of time the job is allowed to run; 
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• directory (path string): the working directory of the job script; 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string): path of the file where the standard error of the job will be stored; 

• stdin (path string): path of the file where the standard error of the job will be stored. 
It also has the following attributes: 

• hostname (string): the name of the Globus host to which the job will be submitted; 

• queue (string): name of the queue. 
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Figure 17 

7.1.9 GridBus 

Group definition for the GridBus middleware [i.6]. 
The GridBus element has a single child element: 

• arguments (argument list): list of arguments passed to the job executable. 
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7.1.10 IBM Load Leveler 

Group definition for IBM's Load Leveler job scheduler [i.7]. 

The Load Leveler group definition has the following child elements: 

• directory (path string): the working directory of the job script; 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string) path of the file where the standard error of the job will be stored; 

• resources (string) a resource string as defined by the 'resources' parameter in the IBM Load Leveler: Using 
and Administering document [i.7]; 



ETSI 



25 



ETSI TS 102 827 V1.1.1 (2008-08) 



• maxTime (time format string): the maximum amount of real time the job is allowed to run; 

• arguments (argument list): list of arguments passed to the job executable; 

• taskRepartition (structure): this element contains the following element tree; 

modeBlock: 

■ totalTasks (positive integer): total number of tasks to run on all available nodes 

■ blocking (positive integer): base factor of which multiples will be used to determine the number of 
tasks to run per node. 

modeTotalTasks : 

■ totalTasks (positive integer): total number of tasks to run on all available nodes; 

■ node (positive integer): number of nodes requested. 
modeTasksPerNode: 

■ tasksPerNode (positive integer): number of tasks to run on a single node; 

■ node (positive integer): number of nodes requested. 
modeGeometry: 

■ taskGeometry (string): group tasks so they will run together on the same node (see IBM Load 
Leveler: Using and Administering document [i.7]). 

It also has the following attribute: 

• jobName (string): the name of the job. 
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7.1.11 LSF 

Group definition for the LSF scheduler [i.8]. 

The LSF group definition has the following child elements: 

• resource (string): this element has the following attributes: 

processorNumber (positive integer): number of processors requested; 

walltime (time): maximum time allowed for the job. 
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• processorsNumber (positive integer): minimum number of processors requested to run the job; 

• resourceRequirement (string): a resource requirement string as defined by the Isf documentation ('Isfintro' 
manpage). 

It also has the following attributes: 

• interactive (boolean): whether the job is interactive or not; 

• jobName (string): name of the job; 

• queue (string): name of the queue the job will be submitted in. 
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7.1.12 Microsoft CCS 

Group Definition for Microsoft's Compute Cluster Server [i.l3]. 
The CCS group definition has the following child elements: 

• resources: the resources that will be allowed to the job. This element can have two children: 

cpus (positive integer): the number of CPUs allocated for the job; 
runtime (time): the maximum runtime allowed for the job. 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string): path of the file where the standard error of the job will be stored. 
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7.1.13 OAR 

Group definition for the OAR job scheduler [i.9]. 

The OAR group definition has the following child elements: 

• resource (string): this element has the following attributes: 
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nodes (positive integer): number of nodes requested; 
cpu (positive integer): number of CPUs requested; 
core (positive integer): number of cores requested; 
walltime (time): maximum time allowed for the job. 
It also can have a string content which is passed verbatim to the '-resource' option of the oarsub command. 
NOTE: The oarsub command is a command of the OAR grid framework. It is defined in [i.9]. 

• directory (path string): the working directory of the job script; 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string): path of the file where the standard error of the job will be stored. 
It has the following attributes: 

• interactive (boolean): start an interactive job. If true, open a login shell on the first node instead of running a 
script (default is false); 

• queue (string): name of the queue to submit the job to; 

• type ('deploy', 'besteffort', 'cosystem', 'checkpoint', 'timesharing'): job type - the default is 'deploy'. 
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7.1.14 PBS /Torque 

Group definition for the Torque job scheduler [i.lO]. 

The PBS/Torque group definition has the following child elements: 

• resource (string): this element has the following attributes: 

nodes (positive integer): number of nodes requested; 
ppn (positive integer): number of CPUs requested; 
walltime (time): maximum time allowed for the job. 

• nodes (positive integer): number of nodes requested; 

• processorsPerNode (positive integer): number of processors per node requested; 

• mailWhen (combination of Abort, Begin, End separated by T): when to send an email (Abort: if the job is 
aborted. Begin: when the job is started. End: when the job terminates); 
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• mailTo (comma-separated list of email addresses): where the job status emails should be sent; 

• joinOutput (boolean): if true, join the output of stderr to stdout; 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string): path of the file where the standard error of the job will be stored. 
It has the following attributes: 

• queue (string): destination queue for the job. The argument can be of the following format: 

queue: a queue on the default server; 
©server: the default queue on the server; 
queue ©server: the queue on the given server. 

• jobName (string 15 chars long, no whitespace, first char must be alphabetic): the name of the job; 

• interactive (boolean): whether the job is interactive or not. 
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7.1.15 PRUN 

Group definition for the PRUN run server [i. 11]. 

The PRUN group definition has the following child elements: 

• resource (string): this element has the following attributes: 

nodes (positive integer): number of nodes requested; 
ppn (positive integer): number of CPUs requested; 
walltime (time): maximum time allowed for the job. 

• stdout (path string): name of the file in which the results will be printed. 
It has no attribute. 
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7.1.16 Sun Grid Engine 

Group definition for the Grid Engine fi-amework [i.l2]. 

The Sun Grid Engine group definition has the following child elements: 

• resource (string): this element has the following attributes: 

nodes (positive integer): number of nodes requested; 

parallelEnvironment (string): the name of the Grid Engine parallel environment which will be 
instantiated; 

walltime (time): maximum time allowed for the job. 

• directory (path string): the working directory of the job script; 

• stdout (path string): path of the file where the standard output of the job will be stored; 

• stderr (path string): path of the file where the standard error of the job will be stored. 
It also has the following attributes: 

• queue (string): queue name; 

• jobName (string): job name. 
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8 XML files examples (informative) 

8.1 Bridge protocols 
8.1.1 rsh 

<rshBridge id="brSchubby" hostname="schubby . inria . f r" username="${USERNAME} " /> 
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8.1.2 ssh 

<sshBridge id="SEA" hostname="sea . inria . f r" username="${USERNAME} " commandPath=" " /> 

8.1.3 oarsh 

<oarshBridge id="oarbridge" hostname="oargrid. inria . fr" jobId="12" /> 

8.1.4 gsissh 

<gsisshBridge id="gsibridge" hostname="gridll . lal . in2p3 . f r" 
port="2222" certif icate=" $ {HOME} / . globus/usercred .pl2 " /> 



8.2 Group protocols 
8.2.1 GroupSSH 

oshGroup id="LAN_INRIA" hostList = "node2 node4 host[10-20]" username = " $ {USERNAME} 
commandPath="/usr/ local /bin/ ssh" > 
<scriptPath base="proactive" relpath="myscript . sh" /> 

</sshGroup> 



8.2.2 GroupRSH 



<rshGroup id="LAN_INRIA" hostList="node2 node4 host[10-20]" username="$ {USERNAME} " > 

<scriptPath base="proactive" relpath="myscript . sh" /> 
</rshGroup> 



8.2.3 GroupOARSH 



<oarshGroup id="oarshgroup" hostList="hostl host2" jobId="42"> 

<scriptPath base="proactive" relpath="scripts/unix/cluster/oarStartRuntime . sh" /> 
</oarshGroup> 



8.2.4 ARC (Nordugrid) 



<arcGroup id="arcgroup" jobName="arcjob" > 

<scriptPath base="root" 
relpath="/usr/ local/arc/script s/unix/cluster/startRuntime . sh" /> 

<stderr>trace/err . log</stderr> 

<maxTime >10000000< /maxTime > 
</arcGroup> 



8.2.5 CGSP China Grid 



<cgspGroup id="cgspgroup" hostname="cgsp . inria . fr" > 

<scriptPath base="root" relpath=" . /calc" /> 
< count > 5 < /count > 

<directory>datadir/jobdatal</directory> 
<stdout>trace/results . log</stdout> 
<stderr> trace /err. log</stderr> 

</cgspGroup> 



8.2.6 EGEE gLite 



<gLiteGroup id="gliteGroup" virtualOrganisation= "proactive" jobType=" normal" 

retryCount="3"> 

<rank>-other . GlueCEStateEstimatedResponseTime</rank> 

<stdout>stdout . log</stdout> 

<stderr>error . log</stderr> 

<conf igFile> script s/unix/proactiveVO/proactiveVO. conf </conf igFile> 
< / gL i t eGroup > 
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8.2.7 Fura/lnnerGrid 



<furaGroup id="furagroup" jobName="furajob" > 

<scriptPath base="root" relpath="/usr/local/fura/scripts/jobscript . sh" /> 

<description>Fura job descriptor sample</description> 

<stdout>trace/results . log</stdout> 

<stderr>trace/err . log</stderr> 

<maxTime >15000000< /maxTime > 
</furaGroup> 



8.2.8 GLOBUS 



<globusGroup hostname="globus_f rontend" id="globusgroup" > 

<count>8< /count > 

<maxTime > 12 < /maxTime > 

<stderr>${GLOBUS_USER_HOME} /error. txt</stderr> 
</globusGroup> 



8.2.9 GridBus 



<gridbusGroup id="gridbusgroup" > 

<scriptPath base="root" relpath=" . /calc" /> 
< argument s> 

<arg>argl</arg> 
<arg>arg2</arg> 
</ argument s> 
</gridbusGroup> 



8.2.10 IBM load leveler 



<loadLevelerGroup id="loadlevelergroup" > 

<scriptPath base="root" relpath="/usr/local/loadleveler/scripts/jobscript . sh" /> 

<directory>datadir/jobdatal</directory> 

<stdout>trace/results . log</stdout> 

<stderr>trace/err . log</stderr> 

<maxTime >15000000< /maxTime > 

< argument s> 

<arg>argl</arg> 

<arg>2 5</arg> 

<arg>foo bar</arg> 
</ argument s> 
<nbTasks>10</nbTasks> 
<tasksPerHost>l</tasksPerHost> 
</loadLevelerGroup> 



8.2.11 LSF 



<lsf Group id="lsf group "> 

<scriptPath base="proactive" relpath="scripts/unix/cluster/startRuntime . sh" /; 

<processorsNumber>2</processorsNumber> 

<resourceRequirement>value="span [ptile=2] "</resourceRequirement> 
</lsfGroup> 



8.2.12 Microsoft CCS 



<ccsGroup id="ccs" bookedNodesAccess="rsh" > 

<resources cpus="9" runtime=" 01 : 01 : 01"/> <! -runtime =days : hours :min 

<stdout>\\HN\work\out</stdout> 

<stderr>\\HN\work\err</stderr> 
</ccsGroup> 



8.2.13 OAR 



<oarGroup bookedNodesAccess="ssh" id="oargroup" interactive="true" > 

<scriptPath base="proactive" relpath="scripts/unix/cluster/oarStartRuntime . sh" /> 

<resource nodes="2" cpu="4" /> 

< s tderr> trace /err . log</stderr> 
</oarGroup> 
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8.2.14 PBS /Torque 



<pbsGroup id="pbsgroupl" queue="queue01@pbsserver" jobName=" demo Job" 

commandPath="/usr/ local /bin/pbs" > 

<scriptPath base="home" relpath="scripts/pbsjob . sh" /> 

<nodes>50</nodes> 
</pbsGroup> 

8.2.15 PRUN 

<prunGroup id="prungroupl" queue="prunqueue"> 

<hostList>prunhost [00-10] </hostList> 
<processorPerNode>2< /processor PerNode> 

< /prunGroup > 

8.2.16 Sun Grid Engine 

<gridEngineGroup id= " gridEngineGroup " > 

<scriptPath base="home" relpath=" jobs/ jobscriptl . sh" /> 
<hostsNumber>10</hostsNumber> 
<wallTime>500000</wallTime> 
<directory> " j obs/ j ob_dat as < /directory > 
<stderr>jobs/jobtrace_err . txt</stderr> 

< /gridEngineGroup > 
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Annex A (normative): 
XML Schema 

A.1 Common types 

<?xml version="l . 0" encoding="UTF-8" ?> 

<xsd: schema xmlns :xsd="http : //www.w3 . org/2 01/XMLSchema" elementFormDefault=" qualified" > 
<xsd: simpleType name="variableRefType" > 
<xsd: restriction base="xsd: string" > 

<xsd:pattern value="\$\ { [A-Za-zO-9 ._] +\ } " /> 
</xsd: restriction> 
</xsd : simpleType> 

<xsd: simpleType name="TimeType" ><! -hour :mn: sec | hour :mn| hour --> 
<xsd: restriction base="xsd: string" > 

<xsd: pattern value="\d\d? { : \d\d) ? { : \d\d) ?" /> 
</xsd: restriction> 
</xsd : simpleType> 

< ! -PosintOrVariableType is defined as a xsdiunion of a positive integer or a variable ref--> 
<xsd: simpleType name=" PosintOrVariableType" > 

<xsd: union memberTypes="xsd:positiveInteger" /> 
</xsd : simpleType> 

< ! -BooleanOrVariableType is defined as a xsdiunion of a positive integer or a variable ref--> 
<xsd: simpleType name =" BooleanOrVariableType" > 

<xsd: union memberTypes="xsd: boolean" /> 
</xsd : simpleType> 
<xsd: simpleType name="TimeOrVariableType" > 

<xsd:union memberTypes="xsd: time" /> 
</xsd : simpleType> 
<xsd: simpleType name="TextOrVariableType" > 

<xsd: union memberTypes="xsd: string" /> 
</xsd : simpleType> 

< ! -ListType is defined as a xsdiunion of a positive integer or a variable ref--> 
<xsd: simpleType name="ListType" > 

<xsd:list itemType="hostnameOrVariableType" /> 
</xsd : simpleType> 

< ! -CloseStreamType is defined as a global xsd: element, it is the xsdiunion of a CloseStream and 
a variable type.--> 

<xsd: simpleType name="CloseStreamOrVariableType" > 

<xsd:union memberTypes="CloseStreamType" /> 
</xsd : simpleType> 

<xsd: simpleType name=" CloseStreamType" > 
<xsd: restriction base="xsd: string" > 
<xsd: enumeration value="yes" /> 
<xsd: enumeration value="no" /> 
</xsd: restriction> 
</xsd : simpleType> 

<xsd: simpleType name="pathElementBaseType" > 
<xsd: restriction base="xsd: string" > 

<xsd: enumeration value="proactive" /> 
<xsd: enumeration value="home" /> 
<xsd: enumeration value="root" /> 
</xsd: restriction> 
</xsd : simpleType> 
<xsd: simpleType name="idType" > 

<xsd: restriction base="xsd: string" > 

<xsd: pattern value=" [0-9a-zA-Z_\-] +" ></xsd:pattern> 
<xsd : whiteSpace value= "collapse " ></xsd : whiteSpace> 
<xsd:minLength value="l" ></xsd:minLength> 
</xsd: restriction> 
</xsd : simpleType> 
<xsd: simpleType name="capacityType" > 

<xsd: restriction base="xsd: string" > 

<xsd:pattern value=" { [0-9] +) |max" ></xsd:pattern> 
<xsd : whiteSpace value= "collapse" ></xsd : whiteSpace> 
</xsd: restriction> 
</xsd : simpleType> 

<xsd: simpleType name="pathElementGeneralType" > 
<xsd: restriction base="xsd: string" > 

<xsd : whiteSpace value= "collapse" ></xsd : whiteSpace> 
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</xsd: restriction> 
</xsd : simpleType> 
<xsd: complexType name="pathElementType" > 

<xsd: attribute name="base" type="pathElementBaseType" use="required" ></xsd: attribute> 
<xsd: attribute name="relpath" type="pathElementGeneralType" use=" required" ></xsd: attribute> 
</xsd : complexType> 
<xsd: complexType name="pathType" > 
<xsd : sequence> 

<xsd:element name="pathElement" type="pathElementType" maxOccurs= "unbounded" 
minOccurs="l" ></xsd: element > 
</xsd : sequence> 
</xsd: complexType > 

<xsd: complexType name="classpathType" > 
<xsd: complexContent> 

<xsd: extension base="pathType" > 

<xsd: attribute name="type" use= " required" > 
<xsd : simpleType> 

<xsd: restriction base="xsd: string" > 

<xsd: enumeration value=" append" ></xsd: enumeration> 
<xsd: enumeration value=" overwrite" ></xsd: enumeration> 
</xsd: restriction> 
</xsd : simpleType> 
</xsd : attribute> 
</xsd : extension> 
</xsd: complexContent> 
</xsd: complexType > 
<xsd: simpleType name="osType" > 

<xsd: restriction base="xsd: string" > 

<xsd: enumeration value ="unix" ></xsd: enumeration> 
<xsd: enumeration value=" windows" ></xsd: enumeration> 
<xsd: enumeration value="cygwin" ></xsd: enumeration> 
</xsd: restriction> 
</xsd : simpleType> 
<xsd: simpleType name="osOrVariableType" > 

<xsd:union memberTypes="osType" /> 
</xsd : simpleType> 
<xsd: simpleType name="hostnameType" > 

<xsd:union memberTypes="xsd: string" /> 
</xsd : simpleType> 
<xsd: simpleType name="hostnameOrVariableType" > 

<xsd:union memberTypes="hostnameType" /> 
</xsd : simpleType> 
<xsd: simpleType name="usernameType" > 

<xsd: restriction base="xsd: string" > 

<xsd:pattern value = " [a-zO-9] +" /> 
</xsd : restriction> 
</xsd : simpleType> 
<xsd: simpleType name="usernameOrVariableType" > 

<xsd:union memberTypes="usernameType" /> 
</xsd : simpleType> 

<xsd: complexType name="environmentElementType" /> 
<xsd: complexType name="variableType" > 
<xsd: complexContent> 

<xsd: extension base="environmentElementType" > 
<xsd: attribute name="name"> 
<xsd : simpleType> 

<xsd: restriction base="xsd: string" ></xsd: restriction> 
</xsd : simpleType> 
</xsd: attribute> 
<xsd: attribute name="value" > 
<xsd : simpleType> 

<xsd: restriction base="xsd: string" ></xsd: restrict ion> 
</xsd : simpleType> 
</xsd : attribute> 
</xsd : extension> 
</xsd: complexContent> 
</xsd : complexType> 

<xsd: complexType name="includeFileType" > 
<xsd: complexContent> 

<xsd: extension base="environmentElementType" > 

<xsd: attribute name=" location" type="xsd: string" use=" required" /> 
</xsd : extension> 
</xsd: complexContent> 
</xsd : complexType> 

<xsd: element name="abstractEnvironmentElement" abstract =" true" 
type="environmentElementType"></xsd: element > 
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<xsd: element name="descriptorVariable" subs ti tut ionGroup=" abstract Environment Element" 
type="variableType" ></xsd: element > 

<xsd: element name="descriptorDef aultVariable" subs ti tut ionGroup=" abstract Environment Element" 
type="variableType" ></xsd: element > 

<xsd: element name=" javaPropertyVariable" subs ti tut ionGroup=" abstract Environment Element" 
type="variableType" ></xsd: element > 

<xsd: element name="programVariable" substitutionGroup="abstractEnvironmentElement" 
type="variableType" ></xsd: element > 

<xsd: element name="programDef aultVariable" substitutionGroup="abstractEnvironmentElement" 
type="variableType"></xsd: element > 

<xsd: element name=" javaPropertyDe script orDe fault" subs ti tut ionGroup=" abstract Environment Element'' 
type="variableType"></xsd: element > 

<xsd : element name= " j avaPropertyProgramDef ault " subst itut ionGroup= " abstractEnvironmentElement " 
type="variableType"></xsd: element > 

<xsd: element name="includePropertyFile" subs ti tut ionGroup=" abstract Environment Element" 
type="includeFileType" ></xsd: element > 

<xsd: complexType name="environmentType" > 
<xsd : sequence> 

<xsd:element ref=" abstractEnvironmentElement" maxOccurs="unbounded" /> 
</xsd : sequence> 
</xsd : complexType> 

<xsd: complexType name="environmentVariablesType" > 
<xsd : sequence> 

<xsd:element name="variable" type="variableType" maxOccurs="unbounded" /> 
</xsd : sequence> 
</xsd: complexType > 

<xsd: complexType name="argumentListType" > 
<xsd : sequence> 

<xsd:element name="arg" type="xsd: string" maxOccurs= "unbounded" /> 
</xsd : sequence> 
</xsd : complexType> 
</xsd: schema> 



A.2 Main schema 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xsd: schema xmlns :xsd="http : //www. w3 . org/2 01/XMLSchema" t argetName space = " urn: gem: deployment : 1 . 0'' 

xmlns= "urn : gem : deployment : 1 . " 

xmlns :ns= "urn: gem: deployment : 1 . 0" elementFormDef ault =" qualified" > 

<xsd:include schemaLocation=" . /CommonTypes .xsd" /> 

<xsd: complexType name="abstractTupleElementType" abstract="true" > 

<xsd : sequence> 

<xsd:element name=" environment" type="environmentVariablesType" minOccurs=" 0" /> 

</xsd : sequence> 

<xsd: attribute name="id" type="idType" use=" required" /> 

<xsd: attribute name="commandPath" type="pathElementGeneralType" /> 
</xsd : complexType> 

<xsd: complexType name="abstractGroupElementType" > 
<xsd: complexContent> 

<xsd: extension base="abstractTupleElementType" > 

<xsd: attribute name="username" type="ns :usernameOrVariableType" /> 
</xsd : extension> 
</xsd: complexContent> 
</xsd : complexType> 

<xsd : complexType name= " abstractGroupSchedulerElementType " > 
<xsd: complexContent> 

<xsd: extension base="abstractTupleElementType" > 
<xsd : sequence> 

<xsd: element name="scriptPath" type="pathElementType" minOccurs=" 0" /> 
</xsd : sequence> 

<xsd: attribute name="bookedNodesAccess" use="required" > 
<xsd : simpleType> 

<xsd: restriction base="xsd: string" > 
<xsd: enumeration value="rsh" /> 
<xsd: enumeration value="ssh" /> 
<xsd: enumeration value="oarsh" /> 
</xsd: restriction> 
</xsd : simpleType> 
</xsd : attribute> 
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</xsd : extension> 
</xsd: complexContent> 
</xsd : complexType> 

<xsd: element name="abstractShElement" type="abstractTupleElementType" ></xsd: element > 

<xsd: complexType name="peerSetType" > 

<xsd : sequence> 

<xsd:element name="peer" type="xsd: string" maxOccurs= "unbounded" /> 

</xsd : sequence> 
</xsd : complexType> 

<!-a 'MAX' xsd: string constant --> 
<xsd: simpleType name="MAX"> 

<xsd: restriction base="xsd: string" > 

<xsd: enumeration value="MAX" ></xsd: enumeration> 

</xsd: restrict ion> 
</xsd : simpleType> 

<xsd: simpleType name="lookupProtocolType" > 
<xsd: restriction base="xsd: string" > 

<xsd: enumeration value="RMI" ></xsd: enumeration> 
<xsd: enumeration value="HTTP" ></xsd: enumeration> 
<xsd: enumeration value="IBIS" ></xsd: enumeration> 
</xsd: restriction> 
</xsd : simpleType> 

<xsd: complexType name="localClientType" > 

<xsd: attribute name = "protocol" type ="lookupProtocolType">< /xsd: attribute > 
<xsd: attribute name="port" type="xsd:positiveInteger" ></xsd: attribute> 

</xsd : complexType> 

<xsd: complexType name="p2pType" > 
<xsd : sequence> 

<xsd:element name="localClient" type="localClientType"/> 
<xsd:element name="peerSet" type="peerSetType"/> 
</xsd : sequence> 

<xsd: attribute name =" node sAsked" > 
<xsd : simpleType> 

<xsd: union memberTypes="xsd:positiveInteger MAX" /> 
</xsd : simpleType> 
</xsd : attribute> 
</xsd : complexType> 

<xsd: complexType name="lookupType" > 

<xsd: attribute name="type" type="lookupProtocolType" ></xsd: attribute > 
<xsd: attribute name="hostList" type="xsd: string" ></xsd: attribute> 
<xsd: attribute name="port" type="xsd:positiveInteger" ></xsd: attribute> 

</xsd : complexType> 

<xsd: complexType name="acquisitionType" > 
<xsd : sequence> 

<xsd:element name="lookup" type="lookupType" minOccurs=" 0" maxOccurs="unbounded"/> 
<xsd:element name="p2p" type="p2pType" minOccurs=" 0" maxOccurs="l" /> 
</xsd : sequence> 
</xsd : complexType> 

<xsd: complexType name="abstractResourceType" ></xsd: complexType > 

<xsd: complexType name="groupRefType" > 
<xsd: complexContent> 

<xsd: extension base="abstractResourceType" > 
<xsd : sequence> 

<xsd:element name="host" type="hostRefType" ></xsd: element> 
</xsd : sequence> 

<xsd: attribute name="refid" type="idType" use="required" /> 
</xsd : extension> 
</xsd: complexContent> 
</xsd: complexType > 

<xsd: complexType name="bridgeRefType" > 
<xsd: complexContent> 

<xsd: extension base="abstractResourceType" > 
<xsd : sequence> 

<xsd:element name="group" type="groupRefType" minOccurs=" 0" 
maxOccurs=" unbounded" ></xsd: element > 
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<xsd:element name="bridge" type="bridgeRefType" minOccurs="0" 
maxOccurs=" unbounded" ></xsd: e lament > 

<xsd:element name="host" type="hostRefType" minOccurs=" 0" maxOccurs="l" /> 
</xsd : sequence> 

<xsd: attribute name="refid" type="idType" use="required" /> 
<xsd: attribute name=" relay" type="xsd: string" ></xsd: attribute> 
</xsd : extension> 
</xsd: complexContent> 
</xsd : complexType> 

<xsd: element name="abstractResourceElement" abstract="true" 
type="abstractResourceType" ></xsd: element > 

<xsd: element name =" group" substitutionGroup="abstractResourceElement" 
type="groupRefType" ></xsd: element > 

<xsd: element name=" bridge" subs ti tut ionGroup="abstractResourceElement" 
type="bridgeRefType" ></xsd: element > 

<xsd: complexType name="resourceType" > 
<xsd : sequence> 

<xsd:element name="host" type="hostRefType" minOccurs=" 0" maxOccurs="l" ></xsd: element> 
<xsd: element ref ="abstractResourceElement" minOccurs=" 0" 
maxOccurs=" unbounded" ></xsd: element > 
</xsd : sequence> 
</xsd: complexType > 

<xsd: complexType name="toolType" > 

<xsd: attribute name="id" type="xsd: string" ></xsd: attribute> 

<xsd: attribute name="path" type="pathElementGeneralType" ></xsd: attribute> 

<xsd: attribute name= "version" type="xsd: string" ></xsd: attribute > 

</xsd : complexType> 

<xsd: complexType name="homeDirectoryType" > 
<xsd: complexContent> 

<xsd: restriction base="pathElementType" > 

<xsd: attribute name="base" type="pathElementBaseType" fixed="root" 
use=" required" ></xsd: attribute> 

<xsd: attribute name="relpath" type="pathElementGeneralType" 
use=" required" ></xsd: attribute> 
</xsd: restriction> 
</xsd: complexContent> 
</xsd : complexType> 

<xsd: complexType name="hostType" > 
<xsd : sequence> 

<xsd: element name="homeDirectory" type="homeDirectoryType" ></xsd: element > 
<xsd: element name="tool" type="toolType" minOccurs="0" 
maxOccurs=" unbounded" ></xsd: element > 

<xsd:element name="networkInterf ace" minOccurs=" 0" maxOccurs="l" > 
<xsd: complexType > 

<xsd: attribute name="name" type="ns :TextOrVariableType" use="required"/> 
</xsd: complexType > 
</xsd : element> 
</xsd : sequence> 

<xsd: attribute name="id" type="idType" use="required" ></xsd: attribute> 
<xsd: attribute name="os" type="osOrVariableType" use="required"></xsd: attribute> 
<xsd: attribute name="username" type="TextOrVariableType"></xsd: attribute> 
<xsd: attribute name="hostCapacity" type="PosintOrVariableType" use="optional" /> 
<xsd: attribute name="vmCapacity" type="PosintOrVariableType" use="optional" /> 
</xsd : complexType> 

<xsd: complexType name="hostRefType"> 

<xsd: attribute name="refid" type= " idType " use=" required" /> 
</xsd: complexType > 

<xsd: complexType name="abstractlnf rastructureType" ></xsd: complexType > 

<xsd: complexType name="hostsType" > 

<xsd: sequence > 

<xsd:element name="host" type="hostType" minOccurs="l" maxOccurs="unbounded" /> 

</xsd : sequence> 
</xsd : complexType> 

<xsd: complexType name="groupsType" > 
<xsd: sequence minOccurs="l"> 

<xsd:element ref ="abstractShElement" minOccurs="l" maxOccurs="unbounded" ></xsd: element> 
</xsd : sequence> 
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</xsd : complexType> 

<xsd: complexType name="abstractBridgeElementType" > 

<xsd: attribute name="id" type="idType" use=" required" /> 
</xsd : complexType> 

<xsd: element name="abstractBridgeElement" type="abstractBridgeElementType" ></xsd: element > 

<xsd: complexType name =" bridge sType" > 

<xsd : sequence> 

<xsd: element ref ="abstractBridgeElement" maxOccurs=" unbounded" ></xsd: element > 

</xsd : sequence> 
</xsd: complexType > 

<xsd: complexType name="inf rastructureType" > 
<xsd: all> 

<xsd:element name="hosts" type="hostsType" minOccurs=" 0" /> 
<xsd:element name="groups" type="groupsType" minOccurs=" 0" /> 
<xsd:element name= "bridges" type="bridgesType" minOccurs="0" /> 
</xsd: all> 
</xsd : complexType> 

<xsd: element name="GCMDeployment" > 
<xsd: complexType > 
<xsd : sequence> 

<xsd:element name=" environment" type="environmentType" minOccurs=" 0" /> 
<xsd:element name=" resources" type="resourceType" /> 

<xsd:element name="acquisition" type="acquisitionType" minOccurs=" 0" /> 
<xsd:element name="inf rastructure" type="inf rastructureType" /> 
</xsd : sequence> 
</xsd : complexType> 

<! -Groups ref id/id key correctness --> 

< ! - - - - > 

<xsd:key name="idKeyGroups" > 

<xsd: selector xpath="ns : inf rastructure/ns igroups/*" /> 

<xsd: field xpath="@id" /> 
</xsd:key> 
<xsd:keyref name="ref IdKeyGroups" ref er="idKeyGroups" > 

<xsd: selector xpath="ns : resources /ns : group" ></xsd: selector> 

<xsd: field xpath="@ref id" ></xsd: f ield> 
</xsd:keyref > 

<! -Bridges ref id/id key correctness --> 

< ! - - - - > 

<xsd:key name="idKeyBridges" > 

<xsd: selector xpath="ns : inf rastructure/ns ibridges/*" /> 

<xsd: field xpath="®id" /> 
</xsd:key> 
<xsd:keyref name="ref IdKeyBridge" ref er="idKeyBridges" > 

<xsd: selector xpath="ns : re sources /ns : bridge" ></xsd: selector > 

<xsd: field xpath="@ref id" ></xsd: f ield> 
</xsd:keyref > 

<! -Hosts ref id/id key correctness --> 

< ! - - - - > 

<xsd:key name="idKeyHosts" > 

<xsd: selector xpath="ns : inf rastructure/ns ihosts/*" /> 

<xsd: field xpath="®id" /> 
</xsd:key> 
<xsd:keyref name="ref IdKeyHost" ref er="idKeyHosts" > 

<xsd: selector xpath="ns : resources /ns :host" ></xsd: select or > 

<xsd: field xpath="@ref id" ></xsd: f ield> 
< /xsd : keyref > 
<xsd:keyref name="ref IdKeyGroupHost" ref er="idKeyHosts" > 

<xsd: selector xpath="ns : resources /ns :group/ns :host" ></xsd: selector> 

<xsd: field xpath="@ref id" ></xsd: f ield> 
< /xsd : keyref > 

</xsd : element> 
</xsd: schema> 
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A.3 Bridges 
A.3.1 rsh 

<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www. w3 . org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 
<xs : complexType name="bridgeTypeRSH" > 
<xs : complexContent> 

<xs : extension base="abstractBridgeElementType" > 

<xs : attribute name=" hostname" type="hostnameType" use=" required" /> 
<xs :attribute name="username" type="usernameType"/> 
<xs : attribute name="commandPath" type="xs : string" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs : element name="rshBridge" type="bridgeTypeRSH" subs ti tut ionGroup="abstractBridgeElement"/> 

</xs : schema> 



A.3.2 ssh 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www. w3 .org/2 01/XMLSchema" 

targetNamespace= "urn: gem: deployment : 1 . 0" 

xmlns=" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs : include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="bridgeTypeSSH" > 
<xs : complexContent> 

<xs : extension base="abstractBridgeElementType" > 
<xs : sequence> 

<xs:element name = "privateKey" type="pathElementType" minOccurs = " 0" maxOccurs = "l'' 
/> 

</xs : sequence> 

<xs : attribute name=" hostname" type="hostnameType" use=" required" /> 
<xs :attribute name="username" type="usernameType"/> 
<xs : attribute name="commandPath" type="xs : string" /> 
<xs : attribute name="commandOptions" type="xs : string" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs : element name="sshBridge" type="bridgeTypeSSH" substitutionGroup="abstractBridgeElement"/> 
</xs : schema> 



A.3.3 gsissh 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www. w3 .org/2 001/XMLSchema" 

targetNamespace= "urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs:include schemaLocation=" . /BridgeGSISSHSchema .xsd" /> 

<xs : complexType name="bridgeTypeGSISSH" > 
<xs : complexContent> 
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<xs : extension base="bridgeTypeSSH"> 

<xs : attribute name="port" type="PosintOrVariableType" /> 
<xs : attribute name="certif icate" type="xs : string"/> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs: element name="gsisshBridge" type="bridgeTypeGSISSH" 
subst itut ionGroup= " abstractBridgeElement " / > 
</xs : schema> 



A.3.4 oarsh 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www.wS . org/2 01/XMLSchema" 

targetNamespace= "urn: gem: deployment : 1 . 0" 

xmlns= "urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:inelude sehemaLoeation=" . ./. . /sehema/DeploymentDeseriptorSehema .xsd"/> 

<xs:inelude sehemaLoeation=" . /BridgeSSHSehema .xsd" /> 

<xs : eomplexType name="bridgeTypeOARSH" > 
<xs : eomplexContent> 

<xs : extension base="bridgeTypeSSH" > 

<xs : attribute name="jobId" type="PosintOrVariableType" use="required"/> 
</xs : extension> 
</xs : eomplexContent> 
</xs : eomplexType> 

<xs: element name="oarshBridge" type="bridgeTypeOARSH" 
substitutionGroup="abstraetBridgeElement"/> 
</xs : sehema> 



A.4 Groups 
A.4.1 GroupSSH 



<?xml version="l . 0" eneoding="UTF-8"?> 

<xs : sehema xmlns :xs="http : //www. w3 . org/2 001/XMLSehema" 

targetNamespaee=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:inelude sehemaLoeation=" . ./. . /sehema/DeploymentDeseriptorSehema .xsd"/> 

<xs : eomplexType name="groupTypeSSH" > 
<xs : eomplexContent> 

<xs : extension base="abstraetGroupElementType" > 
<xs : sequenee> 

<xs:element name="privateKey" type="pathElementType" minOeeurs = "0" maxOeeurs = "l'' 

/> 

</xs : sequenee> 

<xs : attribute name="eommandOptions" type="xs : string" /> 
<xs : attribute name="hostList" type="xs : string" use="required"/> 
</xs : extension> 
</xs : eomplexContent> 
</xs : eomplexType> 

<xs:element name="sshGroup" substitutionGroup="abstraetShElement" type="groupTypeSSH"/> 
</xs : sehema> 
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A.4.2 GroupRSH 

<?xml version="l . 0" encoding="UTF-8"?> 

<xs : schema xmlns :xs="http : //www. w3 . org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="groupTypeRSH" > 
<xs : complexContent> 

<xs : extension base="abstractGroupElementType" > 

<xs : attribute name="hostList" type="xs : string" use=" required" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType > 

<xs: element name="rshGroup" substitutionGroup="abstractShElement" type="groupTypeRSH" /> 
</xs : schema> 

A.4.3 GroupOARSH 

<?xml version="l . 0" encoding="UTF-8"?> 

<xs : schema xmlns :xs="http : //www.w3 .org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 
<xs:include schemaLocation=" . /GroupSSHSchema .xsd" /> 

<xs : complexType name="oarshGroupType" > 
<xs : complexContent> 

<xs : extension base="groupTypeSSH" > 

<xs : attribute name="jobId" type="PosintOrVariableType" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType > 

<xs : element name="oarshGroup" type="oarshGroupType" subs ti tut ionGroup="abstractShElement"/> 
</xs : schema> 

A.4.4 ARC (NorduGrid) 

<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www.w3 .org/2 01/XMLSchema" 

targetNamespace= "urn : gem : deployment : 1 . " 

xmlns=" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="arcProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 

<xs: element name="count" type="PosintOrVariableType" 

minOccurs="0" /> 
<xs: element name=" arguments" type="argumentListType" 

minOccurs="0" /> 
<xs: element name="inputFiles" 

type="arcFileTransf erType" minOccurs=" 0" /> 
<xs: element name="outputFiles" 

type="arcFileTransf erType" minOccurs="0" /> 
<xs: element name="stdout" 

type="pathElementGeneralType" minOccurs="0" /> 
<xs: element name="stderr" 

type="pathElementGeneralType" minOccurs=" 0" /> 
<xs: element name="stdin" 
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type="pathElementGeneralType" minOccurs="0" /> 
<xs: element name="maxTime" 

type="PosintOrVariableType" minOccurs="0" /> 
<xs:element name="notify" type="xs : string" minOccurs=" 0" /> 
</xs : sequence> 

<xs : attribute name=" jobName" type="xs : string" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs : complexType name="arcFileTransf erType" > 
<xs : sequence> 

<xs: element name="transf er" > 
<xs : complexType> 

<xs :attribute name="f ilename" type="xs : string" /> 
<xs : attribute name=" location" type="xs : string" /> 
</xs : complexType> 
</xs : element> 
</xs : sequence> 
</xs : complexType > 

<xs: element name="arcGroup" type="arcProcessType" 

substitutionGroup="abstractShElement" > 
</xs : element> 

</xs : schema> 



A.4.5 CGSP China Grid 

<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www.w3 . org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns=" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./• . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="cgspProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 

<xs: element name=" count" type="PosintOrVariableType" minOccurs=" 0" /> 
<xs:element name= "directory" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="stdout" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="stderr" type="pathElementGeneralType" minOccurs=" 0" /> 
</xs : sequence> 

<xs :attribute name="hostname" type="xs : string" /> 
<xs : attribute name="queue" type="xs : string" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType > 

<xs : element name="cgspGroup" type="cgspProcessType" substitutionGroup="abstractShElement"/> 

</xs : schema> 



A.4.6 EGEE gLite 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www.w3 .org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="gLiteProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupElementType" > 
<xs : sequence> 

<xs:element name="inputData" type="gLiteInputDataType" minOccurs=" 0" /> 
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<xs:element name="rank" type="gLiteRankType" /> 

<xs:element name="stdout" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs: element name="stderr" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="stdin" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="conf igFile" type="pathElementGeneralType" minOccurs="0" /> 
<xs:element name=" arguments" type="argumentListType" minOccurs="0" /> 

</xs : sequence> 

<xs : attribute name=" hostname" type="xs : string" /> 

<xs :attribute name="virtualOrganisation" type="xs : string" use=" required" /> 

<xs : attribute name="Type" type="xs : string" def ault=" job" /> 

<xs lattribute name=" executable" type="xs : string" def ault="/bin/sh" /> 

<xs : attribute name=" jobType" type="xs : string" def ault="normal" /> 

<xs : attribute name="nodeNumber" type="xs : string" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

< ! -gLiteRankType- - > 

<xs : complexType name="gLiteRankType" > 

<xs : simpleContent> 

<xs : extension base="TextOrVariableType"> 

<xs : attribute name="fuzzyrank" type="BooleanOrVariableType" def ault="f alse" /> 
</xs : extension> 

</xs : simpleContent> 
</xs : complexType> 
< ! -gLitelnputDataType- - > 
<xs : complexType name="gLiteInputDataType" > 

<xs : attribute name="dataAccessProtocol" type="xs : string" /> 

<xs : attribute name="storageIndex" type="xs : string" /> 

<xs : attribute name="dataCatalog" type="xs : string" /> 
</xs : complexType > 
<!-end of gLiteProcessType --> 

<xs : element name="gLiteGroup" type=" gLiteProcessType" subs ti tut ionGroup="abstractShElement"/> 

</xs : schema> 

A.4.7 Fura/ InnerGrid 

<?xml version="l . 0" encoding="UTF-8"?> 

<xs : schema xmlns :xs="http : //www.w3 . org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="furaProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 

<xs:element name="description" type="xs : string" minOccurs="0" /> 
<xs:element name="stdout" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="stderr" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="stdin" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="maxTime" type="PosintOrVariableType" minOccurs="0" /> 
</xs : sequence> 

<xs : attribute name=" jobName" type="xs : string" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType > 

<xs : element name="furaGroup" type="furaProcessType" substitutionGroup="abstractShElement"/> 

</xs : schema> 
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A.4.8 GLOBUS 

<?xml version="l . 0" encoding="UTF-8"?> 

<xs : schema xmlns :xs="http : //www. w3 . org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="globusProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 

<xs:element name="count" type="PosintOrVariableType" minOccurs="0" /> 
<xs:element name="maxTime" type="PosintOrVariableType" minOccurs=" 0" /> 
<xs:element name= "directory" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="stdout" type="pathElementGeneralType" minOccurs="0" /> 
<xs:element name="stderr" type="pathElementGeneralType" minOccurs="0" /> 
<xs:element name="stdin" type="pathElementGeneralType" minOccurs="0" /> 
</xs : sequence> 

<xs : attribute name="hostname" type="xs : string" use="required" /> 
<xs : attribute name="queue" type="xs : string" use="optional" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs : element name="globusGroup" type="globusProcessType" substitutionGroup="abstractShElement"/> 
</xs : schema> 



A.4.9 GridBus 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www.w3 .org/2 01/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns=" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="gridbusProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 

<xs:element name=" arguments" type="argumentListType" minOccurs="0" /> 
</xs : sequence> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType > 

<xs: element name="gridbusGroup" type="gridbusProcessType" 
subst itut ionGroup= " abstractShElement " / > 

</xs : schema> 



A.4.10 IBM load leveler 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www. w3 .org/2 001/XMLSchema" 

targetNamespace= " urn : gem : deployment : 1 . " 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="loadLevelerProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 
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minOccurs= 



/> 



<xs:element name= "directory" type="pathElementGeneralType" minOccurs="0" 

<xs:element name="stdout" type="pathElementGeneralType" minOccurs=" 0" /> 

<xs:element name="stderr" type="pathElementGeneralType" minOccurs=" 0" /> 

<xs:element name=" resources" type="xs : string" minOccurs="0" /> 

<xs:element name="maxTime" type="xs : string" minOccurs="0" /> 

<xs:element name=" arguments" type="argumentListType" minOccurs="0" /> 

<xs : element name="taskRepartition" type="LoadLevelerTaskRepartitionType" 



</xs : sequence> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs : complexType name="LoadLevelerTaskRepartitionType" > 
<xs : choice> 

<xs: element name="modeBlock" type="LoadLevelerBlockingGroup" /> 
<xs:element name="modeTotalTasks" type="LoadLevelerTotalTasksGroup" /> 
<xs:element name="modeTasksPerNode" type="LoadLevelerTasksPerNodeGroup" /> 
<xs: element name="modeGeometry" type="LoadLevelerGeometryGroup" /> 
</xs : choice> 
</xs : complexType> 

<xs : complexType name="LoadLevelerBlockingGroup" > 
<xs : sequence> 

<xs:element name="totalTasks" type="xs inonNegativelnteger" /> 
<xs: element name= "blocking" type="xs inonNegativelnteger" /> 
</xs : sequence> 
</xs : complexType > 

<xs : complexType name="LoadLevelerTotalTasksGroup" > 
<xs : sequence> 

<xs: element name="totalTasks" type="xs inonNegativelnteger" /> 
<xs:element name="node" type="xs inonNegativelnteger" /> 
</xs I sequence> 
</xs I complexType > 

<xs I complexType name="LoadLevelerTasksPerNodeGroup" > 
<xs I sequence> 

<xsielement name="tasksPerNode" type="xs inonNegativelnteger" /> 
<xsielement name="node" type="xs inonNegativelnteger" /> 
</xs I sequence> 
</xs I complexType> 

<xs I complexType name="LoadLevelerGeometryGroup" > 
<xs I sequence> 

<xs I element name="taskGeometry" type="xs i string" /> 
</xs I sequence> 
</xs I complexType> 

<xs I element name = "loadLevelerGroup" type="loadLevelerProcessType" 
subs ti tut ionGroup="abstractShElement" /> 
</xs I schema> 



A.4.11 LSF 



<?xml version="l . 0" encoding="UTF-8" ?> 
<xs I schema 

xmlns ixs = "httpi //www.w3 . org/2 1/XMLSchema" 

targetNamespace= " urn i gem i deployment i 1 . " 

xmlns = " urn I gem I deployment 1 1 . 0" 

elementFormDefault=" qualified" > 

<xsiinclude schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd" /> 



" abstractGroupSchedulerElementType " : 



<xs I complexType name="lsfGroupType" > 
<xs I complexContent> 

<xs I extension base 
<xs I sequence> 

<xsielement name=" resources" type="lsfResourcesType" minOccurs="l" /> 
<xsielement name="stdout" type="pathElementGeneralType" minOccurs=" 0" /> 
<xsielement name="stderr" type="pathElementGeneralType" minOccurs=" 0" /> 
</xs I sequence> 

<xs I attribute name="interactive" type="BooleanOrVariableType" use = "optional" 
<xs I attribute name = " jobName" type = "xs i string" use="optional" /> 
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<xs : attribute name="queue" type="xs : string" use="optional" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs:element name="lsfGroup" substitutionGroup="abstractShElement" type="lsfGroupType" /> 

<xs : complexType name="lsfResourcesType" > 
<xs : simpleContent> 

<xs : extension base="xs : string" > 

<xs : attribute name="processorNumber" type="PosintOrVariableType" use="optional"/> 
<xs : attribute name="walltime" use="optional" > 
<xs : simpleType> 

<xs : restriction base="xs : string" > 

<xs:pattern value="\d\d { : \d\d) ?" /> 
</xs : restriction> 
</xs : simpleType> 
</xs : attribute> 
</xs : extension> 
</xs : simpleContent> 
</xs : complexType > 
</xs : schema> 

A.4.12 Microsoft CCS 

<?xml version="l . 0" encoding="UTF-8"?> 

<xs : schema xmlns :xs="http : //www.w3 . org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="ccsProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 

<xs:element name=" resources" type="ccsResourcesType" minOccurs="l" /> 
<xs:element name="stdout" type="pathElementGeneralType" minOccurs=" 0" /> 

<xs:element name="stderr" type="pathElementGeneralType" minOccurs="0" /> 
</xs : sequence> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType > 

<xs: element name="ccsGroup" type="ccsProcessType" substitutionGroup="abstractShElement" /> 

<xs : complexType name="ccsResourcesType" > 
<xs : complexContent> 

<xs : restriction base="xs : anyType" > 

<xs : attribute name="cpus" type="PosintOrVariableType"/> 
<xs : attribute name=" runtime" type="TimeType" use="optional"/> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 

</xs : schema> 



A.4.13 OAR 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www.w3 .org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="oarGroupType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
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<xs : sequence> 

<xs:element name=" resources" type="oarResourcesType" minOccurs="l" /> 
<xs:element name= "directory" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="stdout" type="pathElementGeneralType" minOccurs=" 0" /> 
<xs:element name="stderr" type="pathElementGeneralType" minOccurs=" 0" /> 
</xs : sequence> 

<xs :attribute name="interactive" type="BooleanOrVariableType" use="optional" /> 
<xs : attribute name="queue" type="xs : string" use="optional" /> 
<xs : attribute name="type" use="optional" > 
<xs : simpleType> 

<xs : restriction base="xs : string" > 

<xs : enumeration value="deploy" /> 
<xs : enumeration value="bestef fort" /> 
<xs : enumeration value="cosystem" /> 
<xs : enumeration value=" checkpoint" /> 
<xs : enumeration value=" timesharing" /> 
</xs : restriction> 
</xs : simpleType> 
</xs : attribute> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs : complexType name="oarResourcesType" > 
<xs : simpleContent> 

<xs : extension base="TextOrVariableType" > 

<xs : attribute name="nodes" type="PosintOrVariableType" use="optional"/> 
<xs : attribute name="cpu" type="PosintOrVariableType" use="optional"/> 
<xs lattribute name="core" type="PosintOrVariableType" use="optional"/> 
<xs : attribute name="walltime" type="TimeType" use="optional"/> 

</xs : extension> 
</xs : simpleContent> 
</xs : complexType> 

<xs: element name="oarGroup" type="oarGroupType" substitutionGroup="abstractShElement" /> 
</xs : schema> 



A.4.14 PBS /Torque 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www.w3 . org/2 01/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns=" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./• . /schema/DeploymentDescriptorSchema .xsd"/> 

< ! -PBSProcess--> 

<xs : complexType name="pbsProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 

<xs:element name=" resources" type="pbsResourcesType" minOccurs="l" /> 
<xs: element name="mailwhen" type="xs : string" minOccurs="0" /> 
<xs:element name="mailTo" type="xs : string" minOccurs=" 0" /> 

<xs:element name=" joinOutput" type="BooleanOrVariableType" minOccurs="0" /> 
<xs:element name="stdout" type="pathElementGeneralType" minOccurs="0" /> 
<xs:element name="stderr" type="pathElementGeneralType" minOccurs="0" /> 
</xs : sequence > 

<xs : attribute name="queue" type="xs : string" use="optional" /> 
<xs : attribute name=" jobName" type="xs : string" use= "optional" /> 
<xs : attribute name="interactive" type="xs : boolean" use="optional" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs: element name="pbsGroup" type="pbsProcessType" substitutionGroup="abstractShElement" /> 

<xs : complexType name="pbsResourcesType" > 
<xs : simpleContent> 

<xs : extension base="TextOrVariableType" > 

<xs : attribute name="nodes" type="PosintOrVariableType" use="optional"/> 
<xs : attribute name="ppn" type="PosintOrVariableType" use="optional"/> 
<xs : attribute name="walltime" type="TimeType" use="optional"/> 
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</xs : extension> 
</xs : simpleContent> 
</xs : complexType> 
</xs : schema> 



A.4.15 PRUN 



<?xml version="l . 0" encoding="UTF-8"?> 

<xs : schema xmlns :xs="http : //www. w3 . org/2 001/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns =" urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

<xs : complexType name="prunProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 

<xs:element name=" resources" type="prunResourcesType" minOccurs="l" /> 
<xs:element name="stdout" type="pathElementGeneralType" minOccurs="0" /> 

</xs : sequence> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs: element name="prunGroup" type="prunProcessType" substitutionGroup="abstractShElement" /> 

<xs : complexType name="prunResourcesType" > 
<xs : simpleContent> 

<xs : extension base="TextOrVariableType" > 

<xs : attribute name="nodes" type="PosintOrVariableType" use="optional"/> 
<xs : attribute name="ppn" type="PosintOrVariableType" use="optional"/> 
<xs : attribute name="walltime" type="TimeType" use="optional"/> 
</xs : extension> 
</xs : simpleContent> 
</xs : complexType> 

</xs : schema> 

A.4.16 Sun Grid Engine 

<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema xmlns :xs="http : //www.w3 .org/2 01/XMLSchema" 

targetNamespace=" urn: gem: deployment : 1 . 0" 

xmlns= "urn: gem: deployment : 1 . 0" 

elementFormDefault=" qualified" > 

<xs:include schemaLocation=" . ./. . /schema/DeploymentDescriptorSchema .xsd"/> 

< ! -gridEngine process --> 

<xs : complexType name="gridEngineProcessType" > 
<xs : complexContent> 

<xs : extension base="abstractGroupSchedulerElementType" > 
<xs : sequence> 

<xs:element name=" resources" type="gridEngineResourcesType" minOccurs="l"/> 
<xs:element name="directory" type="pathElementGeneralType" minOccurs="0" /> 
<xs:element name="stdout" type="pathElementGeneralType" minOccurs="0" /> 
<xs:element name="stderr" type="pathElementGeneralType" minOccurs="0" /> 
</xs : sequence> 

<xs : attribute name="queue" type="xs : string" use="optional" /> 
<xs : attribute name=" jobName" type="xs : string" use="optional" /> 
</xs : extension> 
</xs : complexContent> 
</xs : complexType> 

<xs : element name="gridEngineGroup" type="gridEngineProcessType" 
substitutionGroup="abstractShElement"/> 

<xs : complexType name="gridEngineResourcesType" > 
<xs : simpleContent> 
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<xs : extension base="TextOrVariableType" > 

<xs : attribute name="nodes" type="PosintOrVariableType" use="optional"/> 
<xs : attribute name="parallelEnvironment" tySpe="TextOrVariableType" use= 
<xs lattribute name="walltime" type="TimeType" use="optional"/> 

</xs : extension> 



use = "optional "/> 



</xs : simpleContent> 
</xs : complexType> 
</xs : schema> 
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Annex B (informative): 

Examples of deployment descriptor 

B.1 Example 1 

<?xml version="l . 0" encoding="UTF-8" ?> 
<GCMDeployment 

xmlns=" urn: gem: deployment : 1 . 0" 

xmlns :xsi="http : //www.w3 . org/2 01/XMLSchema- instance" 

xsi : schemaLocation= "urn: gem: deployment : 1 . 
http : //proactive . inria . f r/schemas/gcm/1 . 0/ExtensionSchemas .xsd " > 

< environment > 

< javaPropertyVariable name= "user .home" /> 
< /environment > 

<resources> 

<group ref id="gINRIA" > 

<host ref id="hSchubby" /> 

< /group > 
</resources> 

<inf rastructure> 
<hosts> 

<host id="hSchubby" os="unix" hostCapacity="l" vmCapacity="l" > 

<homeDirectory base="root" relpath="$ {user .home} " /> 
</host> 
</hosts> 

< group s> 

<sshGroup id="gINRIA" hostList="schubby cheypa duff" username="cmathieu" /> 
<rshGroup id="grINRIA" hostList="schubby cheypa duff" username="cmathieu" /> 

< /groups > 
</inf rastructure> 

< /GCMDeployment > 



B.2 Example 2 



<?xml version="l . 0" encoding="UTF-8" ?> 
<GCMDeployment 

xmlns= "urn: gem: deployment : 1 . 0" 

xmlns :xsi="http : //www. w3 .org/2 01/XMLSchema- instance" 

xsi : schemaLocation= "urn: gem: deployment : 1 . 
http : //proactive . inria . f r/schemas/gcm/1 . 0/ExtensionSchemas .xsd " > 

< environment > 

<descriptorVariable name="USERNAME" value="j smith" /> 
< /environment > 

<resources> 

<bridge ref id="GATEWAY" /> 

<group refid="COMPANY_LAN"> 

<host refid="BIG_HOST" /> 
< /group > 
</resources> 

<inf rastructure> 
<hosts> 

<host id="BIG_HOST" os="unix" hostCapacity="4 " 
vmCapacity="2" > 
<homeDirectory base="root" 

relpath="/user/${USERNAME}/home" /> 
<tool id="java" path="/usr/java/ j2sdk/bin/java" /> 
<tool id="proactive" 

path="$H0ME/myApps/ProActive_3 .2.1" /> 
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<networkInterf ace name= " ethO " / > 
</host> 
</hosts> 

< group s> 

<lsfGroup id="COMPANY_LAN" bookedNodesAccess="rsh" queue="top"> 
<resources processorNumber="12" walltime=" 01 : 00"/> 
< stdout >output_trace< / stdout > 
<stderr>error_trace</stderr> 
</lsfGroup> 
< /groups > 

<bridges> 

<sshBridge id="GATEWAY" hostname=" sea . inria . f r" 
username="${USERNAME} " commandPath=" " /> 
</bridges> 
</inf rastructure> 

< /GCMDeployment > 
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Annex C (normative): 

Custom bridge and group types 



The schema is designed to allow easy integration of custom extensions for any new bridge or group protocols. The 
standard way to do this is by creating a custom XML Schema element type as an extension of the appropriate abstract 
type abstractBridgeElementType, abstractGroupElementType, or abstractGroupSchedulerElementType. 

The type should then be put in its own schema file, which will reference the main schema one. 

The following example shows an extension schema with a custom group type and a custom bridge type: 

<xs : schema 

targetNamespace= "urn: gem: deployment : extension" 
xmlns= "urn: gem: deployment : extension" 
xmlns : gcmdep= " urn : gem : deployment : 1 . " 
xmlns :xs="http: //www.w3 . org/2 01/XMLSehema" 
elementFormDefault=" qualified" > 

<xs : import 

sehemaLoeation="DeploymentDeseriptorSehema .xsd" 
namespaee=" urn: gem: deployment : 1 . 0"/> 

< ! - 

eustom group 

- - > 

<xs : eomplexType name="myGroupType" > 
<xs : eomplexContent> 

<xs : extension base="gemdep : abstraetGroupElementType"> 

<xs : attribute name="someattr" type="xs : string" /> 
</xs : extension> 
</xs : eomplexContent> 
</xs : eomplexType> 

<xs: element name="myGroup" substitutionGroup="gemdep : abstraetShElement" type="myGroupType" /> 

< ! - 

eustom bridge 

— > 

<xs : eomplexType name="myBridgeType" > 
<xs : eomplexContent> 

<xs : extension base="gemdep : abstraetBridgeElementType" > 

<xs : attribute name="someattr" type="xs : string" /> 
</xs : extension> 
</xs : eomplexContent> 
</xs : eomplexType> 

<xs : element name="myBridge" substitutionGroup="gemdep : abstraetBridgeElement" type="myBridgeType" 
/> 
</xs : sehema> 

Schema extension example - SampleDeploymentExtension.xsd 

The schema can then be used as an auxiliary schema in a descriptor, along with the main schema. Here is a usage 
example: 

<?xml version="l . 0" eneoding="UTF-8" ?> 
<GCMDeployment 

xmlns= "urn: gem: deployment : 1 . 0" 

xmlns :pauext=" urn: gem: deployment : extension" 

xmlns :xsi="http : //www.w3 .org/2 01/XMLSehema- instance" 

xsi : sehemaLoeation= "urn: gem: deployment : 1 . 
http : //proactive . inria . f r/sehemas/gem/1 . 0/ExtensionSehemas .xsd 

urn: gem: deployment : extension SampleDeploymentExtension.xsd 

II 

> 

< environment > 

< javaPropertyVariable name= "user .home" /> 

< j avaPropertyVariable name= " user . name " / > 
< / envi ronment > 

<resources> 

<group refid="gINRIAEXT"> 

<host ref id="hSehubby" /> 
< /group > 
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</resources> 

<inf rastructure> 
<hosts> 

<host id="hSchubby" os="unix" hostCapacity="l" 
vmCapacity="l" > 

<homeDirectory base="root" relpath="${user .home} " /> 
</host> 
</hosts> 

<groups> 

<sshGroup id="LAN_INRIA" hostList="cheypa schubby petawawa naruto" 
username="$ {user .name} " 

commandPath="/usr/ local /bin/ ssh" > 
</sshGroup> 

<pauext : myGroup id="gINRIAEXT" someattr=" f oobar" /> 
< /groups > 

<bridges> 

<pauext imyBridge id="bINRIAEXT" someattr="somevalue" /> 
</bridges> 
</inf rastructure> 

< /GCMDepl oyment > 

Schema extension-example - SampleDescriptor.xml 
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Annex D (informative): 

Symbols used in the schema diagrams 

The following is taken from the <oXygen/> XML Editor User guide (with permission): 
http://www.oxvgenxml.com/doc/ug-oxvgen/xml-schema-diagram-svmbols.html 



person B- 



A rectangle containing a string represents an xs:element with the name attribute having the value equal to the string 
from the rectangle. 



H @ note jB- 



An xs: attribute with the name attribute having the value equal to the string from the rectangle. 



© ##other 



An xs:anyAttribute with the namespace attribute having the value equal to the string from the rectangle. 



An xs:attributeGroup with the ref attribute having the value equal to the string from the rectangle. 

-fn complexPerson Jb- 
An xs:complexType with the name attribute having the value equal to the string from the rectangle. 



personijroup 



An xs: group with the name attribute having the value equal to the string from the rectangle. 



personjtl- 




An xs:element with the ref attribute having the value equal to the string from the rectangle. 



-[17 stringRestriction JB- 
An xs:simpleType with the name attribute having the value equal to the string from the rectangle. 



(^ 



restricts: xs: string B- 



n?)! 



An xs:restriction with the base attribute having the value equal to the string from the rectangle. 



{¥ 



extends: xs:stri 



n^& 



An xs:extension with the base attribute having the value equal to the string from the rectangle. 
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An xs:simpleContent. 



An xsxomplexContent. 



<ff>EH 



<^) 



B- 



An xs:all. 



1..10 
An xs: sequence with the minOccurs and minOccurs attributes specified under the symbol. 



1..CO 



An xsxhoice with the minOccurs and minOccurs attributes specified under the symbol. 



B- 



An xs:annotation. 



An xs: documentation. 



- U uniquel B- 



An xs:unique with the name attribute having the value equal to the string from the rectangle. 



^ empid T3- 



An xs:key with the name attribute having the value equal to the string from the rectangle. 



|g\ key ref1-> empid B- 



An xs:keyref with the name and refer attributes having the value equal to the string from the rectangle. 



-f-^ person J 



An xs:selector with the xpath attribute having the value equal to the string from the rectangle; it is used inside an 
xs:unique, an xs:key or an xs:keyref. 
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- H name/given I 



An xs: field with the xpath attribute having the value equal to the string from the rectangle; it is used inside an 
xs:unique, an xs:key or an xs:keyref. 
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